Menu

Economy-based Player Promotions

Zathrus Writer

Economy-based Player Promotions

This is an event handling function that promotes players (i.e. adds them to different groups) once they accumulated certain wealth. Optionally, players can also be demoted (i.e. removed) from a group once their wealth falls below this group's threshold (toggled in config).


Plugin dependencies

Economy-based Player Promotions require a permission plugin (such as PermissionsEX) and an economy plugin (such as iConomy) to be installed on your server.

Since there are many permission and economy plugins, it would be inefficient for CommandsEX to try and implement them all, as there already is a plugin that does exactly that. This plugin is called Vault and you will need to have it installed on your server for Economy-based Player Promotions to work.


Configuration

There are 4 config options added to accommodate player time-based promotions:

  • ecoPromoteTaskTime - time (in seconds) after which the plugins should periodically check for players' wealth and promote them based on these findings. Default: 180 (3 minutes)
  • ecoPromote - amount of currency (can contain floating point) a player must accumulate before being auto-promoted to each group. There is a default example value provided in the config file and below this text for your reference.
  • ecoPromoteExclude - players in these groups will be excluded from economy-based auto-promotions (useful for admins, moderators, ...) Default: [admin]
  • ecoPromoteAutoDemote - if this is true, players that drop below treshold of their own group will be removed from this group (i.e. demoted) Default: true

Default value of ecoPromote option:

  ecoPromote:
    default: 0

Example usage:

  ecoPromote:
    rich: 5000 # add players with more than 5000 currency into group rich 

How to remove this feature

Should there be a need to manually remove this feature from the JAR file, the following files must be removed: com/github/zathrus_writer/commandsex/handlers/Handler_economypromote.class


Related

Wiki: CommandsEX CraftBukkit plugin Wiki

MongoDB Logo MongoDB